Rename gdk_surface_queue_expose
authorMatthias Clasen <mclasen@redhat.com>
Thu, 30 Jul 2020 02:40:01 +0000 (22:40 -0400)
committerMatthias Clasen <mclasen@redhat.com>
Thu, 30 Jul 2020 02:40:01 +0000 (22:40 -0400)
We don't have expose events anymore; instead, there
is a ::render signal. So rename queue_expose to
queue_render to match.

Update all callers.

docs/reference/gdk/gdk4-sections.txt
gdk/gdksurface.c
gdk/gdksurface.h
gtk/gtkwidget.c
gtk/inspector/fpsoverlay.c
gtk/inspector/updatesoverlay.c

index d8245a6d26446e78668e3fd1a9bfd36283f64e72..7e814ee81faf603f16c9212a9e527524470c3cd0 100644 (file)
@@ -190,7 +190,7 @@ gdk_surface_create_vulkan_context
 gdk_surface_create_cairo_context
 
 <SUBSECTION>
-gdk_surface_queue_expose
+gdk_surface_queue_render
 gdk_surface_get_frame_clock
 
 <SUBSECTION>
index 57febdc98f43f8b70c378d99233277f4ad515be5..a26754b694365a6a99282b4aa1519bd2c5520f5d 100644 (file)
@@ -1355,15 +1355,15 @@ gdk_surface_paint_on_clock (GdkFrameClock *clock,
   g_object_unref (surface);
 }
 
-/**
+/*
  * gdk_surface_invalidate_rect:
  * @surface: a #GdkSurface
  * @rect: (allow-none): rectangle to invalidate or %NULL to invalidate the whole
  *      surface
  *
- * A convenience wrapper around gdk_surface_invalidate_region() which
- * invalidates a rectangular region. See
- * gdk_surface_invalidate_region() for details.
+ * A convenience wrapper around gdk_surface_invalidate_region()
+ * which invalidates a rectangular region.
+ * See gdk_surface_invalidate_region() for details.
  **/
 void
 gdk_surface_invalidate_rect (GdkSurface        *surface,
@@ -1406,19 +1406,17 @@ impl_surface_add_update_area (GdkSurface     *impl_surface,
 }
 
 /**
- * gdk_surface_queue_expose:
+ * gdk_surface_queue_render:
  * @surface: a #GdkSurface
  *
- * Forces an expose event for @surface to be scheduled.
- *
- * If the invalid area of @surface is empty, an expose event will
- * still be emitted. Its invalid region will be empty.
+ * Forces a #GdkSurface::render signal emission for @surface
+ * to be scheduled.
  *
  * This function is useful for implementations that track invalid
  * regions on their own.
  **/
 void
-gdk_surface_queue_expose (GdkSurface *surface)
+gdk_surface_queue_render (GdkSurface *surface)
 {
   cairo_region_t *region;
 
@@ -1434,12 +1432,12 @@ gdk_surface_queue_expose (GdkSurface *surface)
  * @surface: a #GdkSurface
  * @region: a #cairo_region_t
  *
- * Adds @region to the update area for @surface. The update area is the
- * region that needs to be redrawn, or “dirty region.”
+ * Adds @region to the update area for @surface. The update area is
+ * the region that needs to be redrawn, or “dirty region.”
  *
- * GDK will process all updates whenever the frame clock schedules a redraw,
- * so there’s no need to do forces redraws manually, you just need to
- * invalidate regions that you know should be redrawn.
+ * GDK will process all updates whenever the frame clock schedules a
+ * redraw, so there’s no need to do forces redraws manually, you just
+ * need to invalidate regions that you know should be redrawn.
  **/
 void
 gdk_surface_invalidate_region (GdkSurface          *surface,
@@ -1473,8 +1471,8 @@ gdk_surface_invalidate_region (GdkSurface          *surface,
  * _gdk_surface_clear_update_area:
  * @surface: a #GdkSurface.
  *
- * Internal function to clear the update area for a surface. This
- * is called when the surface is hidden or destroyed.
+ * Internal function to clear the update area for a surface.
+ * This is called when the surface is hidden or destroyed.
  **/
 void
 _gdk_surface_clear_update_area (GdkSurface *surface)
@@ -1497,8 +1495,8 @@ _gdk_surface_clear_update_area (GdkSurface *surface)
  * Temporarily freezes a surface such that it won’t receive expose
  * events.  The surface will begin receiving expose events again when
  * gdk_surface_thaw_updates() is called. If gdk_surface_freeze_updates()
- * has been called more than once, gdk_surface_thaw_updates() must be called
- * an equal number of times to begin processing exposes.
+ * has been called more than once, gdk_surface_thaw_updates() must be
+ * called an equal number of times to begin processing exposes.
  **/
 void
 gdk_surface_freeze_updates (GdkSurface *surface)
index 60d80558bffd14747ad6c787a7a8b86f9d0e32ef..077c012a3f397152b54de82c5a0d1f0c62547b23 100644 (file)
@@ -206,7 +206,7 @@ GDK_AVAILABLE_IN_ALL
 void          gdk_surface_beep            (GdkSurface       *surface);
 
 GDK_AVAILABLE_IN_ALL
-void       gdk_surface_queue_expose              (GdkSurface          *surface);
+void       gdk_surface_queue_render       (GdkSurface       *surface);
 
 GDK_AVAILABLE_IN_ALL
 GdkFrameClock* gdk_surface_get_frame_clock      (GdkSurface     *surface);
index 249e5b630dd443c73aa01ec0dbb977a1aadf38df..81b05591dec719c9981b6726ccdce48c4901f144 100644 (file)
@@ -3418,7 +3418,7 @@ gtk_widget_queue_draw (GtkWidget *widget)
       priv->draw_needed = TRUE;
       g_clear_pointer (&priv->render_node, gsk_render_node_unref);
       if (GTK_IS_NATIVE (widget) && _gtk_widget_get_realized (widget))
-        gdk_surface_queue_expose (gtk_native_get_surface (GTK_NATIVE (widget)));
+        gdk_surface_queue_render (gtk_native_get_surface (GTK_NATIVE (widget)));
     }
 }
 
index 9c1e8e58a18304722e6b250496dec3cb48b94195..fcc8da691cdc59cbbe48f38c021ba2240c810631 100644 (file)
@@ -141,7 +141,7 @@ gtk_fps_overlay_force_redraw (GtkWidget     *widget,
                               GdkFrameClock *clock,
                               gpointer       unused)
 {
-  gdk_surface_queue_expose (gtk_native_get_surface (gtk_widget_get_native (widget)));
+  gdk_surface_queue_render (gtk_native_get_surface (gtk_widget_get_native (widget)));
 
   return G_SOURCE_REMOVE;
 }
@@ -251,7 +251,7 @@ gtk_fps_overlay_queue_draw (GtkInspectorOverlay *overlay)
 
   g_hash_table_iter_init (&iter, self->infos);
   while (g_hash_table_iter_next (&iter, &widget, NULL))
-    gdk_surface_queue_expose (gtk_native_get_surface (gtk_widget_get_native (widget)));
+    gdk_surface_queue_render (gtk_native_get_surface (gtk_widget_get_native (widget)));
 }
 
 static void
index 18f1087c167cb2acac43b794a8e53942298f629e..cac2a1c4f3d12a7fb2d22a8a129ff9a357cc5bb2 100644 (file)
@@ -108,7 +108,7 @@ gtk_widget_updates_tick (GtkWidget     *widget,
       gtk_update_free (draw);
     }
 
-  gdk_surface_queue_expose (gtk_native_get_surface (gtk_widget_get_native (widget)));
+  gdk_surface_queue_render (gtk_native_get_surface (gtk_widget_get_native (widget)));
   if (draw)
     {
       g_queue_push_tail (updates->updates, draw);
@@ -249,7 +249,7 @@ gtk_updates_overlay_queue_draw (GtkInspectorOverlay *overlay)
 
   g_hash_table_iter_init (&iter, self->toplevels);
   while (g_hash_table_iter_next (&iter, &widget, NULL))
-    gdk_surface_queue_expose (gtk_native_get_surface (gtk_widget_get_native (widget)));
+    gdk_surface_queue_render (gtk_native_get_surface (gtk_widget_get_native (widget)));
 }
 
 static void